SGPanelItem(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 7 - Sequence Grabber Panel Components / Sequence Grabber Panel Components Reference

Functions / Processing Your Panel's Events

SGPanelItem
Your SGPanelItem function allows your component to receive and process mouse clicks in the settings dialog box.
pascal ComponentResult SGPanelItem (SeqGrabPanelComponent s,
                                     SGChannel c, DialogPtr d,
                                     short itemOffset, 
                                     short itemNum);
s
Identifies the sequence grabber component's connection to your panel component.
c
Identifies a connection to the sequence grabber channel associated with your panel component.
d
Contains a dialog pointer identifying the settings dialog box.
itemOffset
Specifies the offset to your panel's first item in the dialog box.
itemNum
Contains the item number of the dialog item selected by the user. Note that this is an absolute item number; the sequence grabber does not adjust this value to account for the offset to your first dialog item.

DESCRIPTION
A sequence grabber component calls your SGPanelItem function whenever the user clicks an item in the settings dialog box. Your component may then perform whatever processing is appropriate, depending upon the item number. Note that the sequence grabber provides an absolute item number. It is your responsibility to adjust this value to account for the offset to your panel's first item in the dialog box.

SEE ALSO
Your component can filter all dialog events with your SGPanelEvent function. This function is described next.
Sequence grabber components use your component's SGPanelValidateInput function to validate the current input settings as a whole. That function is discussed on page 7-23.